home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / garbage.doc < prev    next >
Text File  |  1995-03-31  |  8KB  |  186 lines
  1. (Comp.sources.hp48) 
  2. Item: 18 by detlef at mwhh.hanse.de 
  3. Author: [Detlef Mueller] 
  4.   Subj: GARBAGE - Sokoban V1.3 
  5.   Date: Tue Nov 12 1991 
  6.  
  7. [Note: Although this game looks almost exactly like MOVE on Goodies Disk #3, 
  8.  it runs much faster.  The frustrating pauses are now gone.  Try it!  -jkh-] 
  9.  
  10. Hi, world. 
  11.  
  12. GARBAGE - yet another SOKOBAN for the HP48. 
  13. This should be the last update for some time B-). 
  14.  
  15. The aim of the game is to solve puzzles of increasing complexity. 
  16.  
  17. Features: 
  18.          - implemented as library (no. 1111, 7602 bytes, checksum #F5FB) 
  19.          - includes *50* levels 
  20.          - high speed 
  21.          - key repeat (to prevent key damage :-) 
  22.          - undo last step 
  23.          - save/restore capability 
  24.          - select a level 
  25.          - go to next/prev level 
  26.  
  27. Changes vs. version 1.2: 
  28.          - add level select 
  29.          - the context data is stored in normal user RAM 
  30.          - remove PGDT 
  31.          - document go to next/prev level 
  32.          - fix level 16 and 36 
  33.  
  34. Installation: 
  35.          To install the game, a) download the library and recall it into the 
  36.          stack. Enter the port number (0,1,2) where you want to store it and 
  37.          press STO. Then key 'GARBAGE.LIB' PURGE. Switch the HP48 off, then on 
  38.          again. GARBAGE will now be installed as a library named GARBAGE (id 
  39.          no. 1111). 
  40.  
  41. Deinstallation: 
  42.          To get rid of the game execute the following commands (if GARBAGE 
  43.          is stored in port 1 or 2, make sure the card switch is set to R/W): 
  44.              HOME                @ switch to the home directory 
  45.              1111 DETACH         @ release GARBAGE library 
  46.              :&:1111 PURGE       @ search and purge GARBAGE 
  47.  
  48. Run: 
  49.          To play it, enter the LIBRARY GARBAGE menu and press the softkey named 
  50.          GARB or just type GARB[ENTER] at the command line. The game starts 
  51.          immediately, coming up with the following screen: 
  52.  
  53.          +---------------------------------+ 
  54.          | ##################   GARBAGE    | 
  55.          | #                #  *********   | 
  56.          | #                #  *       *   | 
  57.          | #                #  *  x    *   | 
  58.          | #                #  *       *   | 
  59.          | #                #  *********   | 
  60.          | ##################   VERSION    | 
  61.          +---------------------------------+ 
  62.  
  63.          Symbol  Means 
  64.  
  65.          *****   A little logo with the actual level number displayed in 
  66.          * x *   the center of it (x). 
  67.          ***** 
  68.  
  69.          #####   The game area (see below). 
  70.          #   # 
  71.          ##### 
  72.  
  73. Keys: 
  74.          Key             Action 
  75.  
  76.          Left arrow      Move actor one step left. Repeats if held down. 
  77.          Right arrow     Move actor one step right. Repeats if held down. 
  78.          Up arrow        Move actor one step up. Repeats if held down. 
  79.          Down arrow      Move actor one step down. Repeats if held down. 
  80.          +/-             Toggle sound on/off 
  81.          STO             Make a snapshot of the game 
  82.          <-              Restore game from last snapshot 
  83.          DEL             Set actual level to initial state (don't affect 
  84.                          saved game) 
  85.          ENTER           Undo last step 
  86.          Blueshift ON    Turn calculator off without leaving GARBAGE 
  87.          Blueshift +     Go to next level 
  88.          Blueshift -     Go to prev. level 
  89.          ON              Leave GARBAGE (Boss key .. :-) 
  90.  
  91. Description (by Gilles Kohl): 
  92.          In GARBAGE, you're in charge of garbage collection inside your HP48. 
  93.          The 'garbage collector' is shown by a cross-shaped symbol. Your task 
  94.          is to collect lost objects and move them onto free storage locations. 
  95.  
  96.          The characters in GARBAGE are: (all shapes 4x4 size, '.' = off, 
  97.          '#' = on) 
  98.  
  99.          .#.. 
  100.          ###.  your 'collector' or mover. 
  101.          .#..  Control using [left], [right], [up] and [down] arrows 
  102.          ....  (appears a little differently on storage locations, see below) 
  103.  
  104.          ###. 
  105.          #.#.  a moveable object. Push them to their storage locations. 
  106.          ###.  you may only push objects (no pulling them) and only one 
  107.          ....  object at a time. 
  108.  
  109.          .... 
  110.          .#..  an empty storage location. Push moveable objects upon them. 
  111.          .... 
  112.          .... 
  113.  
  114.          ###. 
  115.          ###.  successfully filled-up storage location. 
  116.          ###.  (you may still move the object away again, if necessary) 
  117.          .... 
  118.  
  119.          #.#. 
  120.          .#.#  an unmoveable object. No way to move it - just stands in 
  121.          #.#.  your way. 
  122.          .#.# 
  123.  
  124.          .#.. 
  125.          #.#.  the 'mover' above an empty storage location. 
  126.          .#..  (there is no special meaning to this, except to indicate 
  127.          ....   that you're above a storage location) 
  128.  
  129.          The aim of the game is filling up all storage locations by moving 
  130.          all (moveable) objects to them. This successfully completes a 
  131.          garbage collection task, and you're promptly assigned the next one. 
  132.          (Unless you've solved them all). 
  133.  
  134. Things to notice: 
  135.          - On entering a new level (or when you make a snapshot with STO) the 
  136.            game stores information about the context into a variable named 
  137.            'gc.data' (670 bytes in size). If this variable already exists in 
  138.            the path, it will be overwritten. Otherwise GARBAGE generates this 
  139.            variable in the actual directory. The game will always come up with 
  140.            this data (if it is found), so you can inter- rupt your task at 
  141.            every point by pressing STO, then leaving with ON. 
  142.          - It is also possible to select a level. Just store a real number in 
  143.            the range 1 - 50 into 'gc.data' and GARBAGE will come up with the 
  144.            associated level. 
  145.          - If the data stored in 'gc.data' is invalid, the game starts at level 
  146.            1. 
  147.          - The sound toggle (+/-) modifies flag -56 permanently. 
  148.          - GARBAGE doesn't destroy your PICT. 
  149.          - If you get a 'Collection Failed' from the game, please mail me a 
  150.            description of the circumstances and the contents of the stack. 
  151.            GARBAGE traps any error, prints an error message and DOESN'T clean 
  152.            up the stack. Use the interactive stack to view the stack, then 
  153.            execute CLEAR ! 
  154.          - I will maintain this program, so feel free to mail me ideas for 
  155.            improvements or notes of appreciation :-). 
  156.  
  157. Hints: 
  158.          Save early, save often .. ;-) 
  159.          You can hold one context variable in every subdirectory, so more than 
  160.          one person can be playing the game at once. 
  161.  
  162. Credits: 
  163.          1)  Gilles Kohl - posted MOVE in Dec 90 (freeware) 
  164.              I used the algorithms, pictures and parts of the documentation. 
  165.          2)  Douglas R. Cannon - SKUNK 1.0 (freeware, great animations) 
  166.              I used his 'FANFARE' data 
  167.          3)  Yvonne - alpha tester 
  168.          4)  Raymond Hellstern - beta tester 
  169.          5)  Chris Spell - inserted the UUENCODE form of GARBAGE (thanks :-) 
  170.          6)  Markus Witt - reviewed this text 
  171.          7)  W. C. Wickes - \->ASC 
  172.          8)  HP Corvallis - RPL tools/HP48 
  173.          9)  Lutz Vieweg - asks for an undo feature 
  174.          10) Robert Brunner - suggestions 
  175.          11) Dan Ciarniello - reports the bug in level 36, suggestions 
  176.  
  177. Happy playing, 
  178.          8-), Detlef. 
  179.  
  180. P.S.     I don't take the blame for worn calculator keys :-). 
  181.          All songs of praise about the game design to: 
  182.          gilles@disys.dis.incom.de 
  183.  
  184. P.P.S.   Any questions ? Feel free to mail me =-) ... 
  185.  
  186.